package com.example.demo.mapper;

import com.example.demo.entity.Category;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 分类数据访问层接口
 * 负责分类相关的数据库操作
 */
@Mapper
public interface CategoryMapper {
    
    /**
     * 根据ID查询分类
     * @param id 分类ID
     * @return 分类信息
     */
    Category selectById(@Param("id") Long id);
    
    /**
     * 根据名称查询分类
     * @param name 分类名称
     * @return 分类信息
     */
    Category selectByName(@Param("name") String name);
    
    /**
     * 查询所有分类列表（按排序顺序）
     * @return 分类列表
     */
    List<Category> selectAllCategories();
    
    /**
     * 查询有文章的分类列表
     * @return 有文章的分类列表
     */
    List<Category> selectCategoriesWithArticles();
    
    /**
     * 插入分类
     * @param category 分类信息
     * @return 影响的行数
     */
    int insert(Category category);
    
    /**
     * 更新分类
     * @param category 分类信息
     * @return 影响的行数
     */
    int update(Category category);
    
    /**
     * 更新分类文章数量
     * @param id 分类ID
     * @param articleCount 文章数量
     * @return 影响的行数
     */
    int updateArticleCount(@Param("id") Long id, @Param("articleCount") Integer articleCount);
    
    /**
     * 根据ID删除分类
     * @param id 分类ID
     * @return 影响的行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 查询分类总数
     * @return 分类总数
     */
    long selectTotalCount();
}
